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ee Introduction 

: Scope and Purpose 

This document describes the design of the systems software for the TS 
2000 personal computer. Each Chapter describes a logically related set 


of services and/or modifications to the Spectrum ROM. New services 
which are available to programmers are presented with their interfaces. 


: Related Documents 


[1] EG ~ P - 542 Ts 2000 Systems Software Functional Specification by 
Scott McCourt. 


[2] EG - P - 543. TS 2000 Systems Software Architecture by David Boyle 
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'! Tnitialization 
: Introduction 


The TS 2000 undergoes an initialization procedure upon power up. With 
the addition of ROS cartridges and the Bus Expansion Unit changes have 
ope age to allow for the new devices and bank switching. 


This section describes the additions and modifications to the Edit 
_module and the addition of the Init module. This includes the addition 
of a System Configuration Table and some new system variables. 
‘ae ett OBES 44 ator-Rel fo RAm 


fold oe The new system variables are: +0 back on wii Streams ane init Y 
Dy, K  Mideo hee is 
POP a4 SYSCON - address of the System Configuration Table. foc roe owe 
OD MAX BANK - the largest bank number that has been assigned. / Printer huffer 4 
nd po BS. AAX.B AV . screen ave 
@a 


4% 


/ . 
lis The Init routine in module Edit procedes as in the Spectrum until the ie 
cen Dippin ie RAMTOP and CHARS variables are meet ieed The machi ne/GOSUB/ stack is Cn dis ploye 


eg then set up at MSTACK ( (6200H). ni as 
until the copyright message is displayed (this now includes the Timex 
copyright). 


A routine to bootstrap the bank switching code is moved into RAM at 
&000H and is executed. This routine selects the home ROM extension, 
moves the bank switching code into RAM at 6200H, and reselects the home 
ROM. 


The initialization routine then calls GOTO EXT to transfer control to 
EXINIT, the rest of the initialization routine, which resides in the 
extension ROM, 


' The System Configuration Table contains the following information at the 
indicated offsets from the address contained in SYSCON. 


0000 AROS Language Type 

0001 Cartridge Type 

0002 Starting address 

0004 Chunk specification 

0005 Autostart specification 

0006 # of bytes for machine language variables 

0008 Cartridge type (start of LROS information) 

0009 Starting address 

OO0B Chunk specification - 

Q00C Presence flag (start of expansion bank information) 
O000D Bank number 

QOOE Device specification (Chunk specification if RAM) 


OOUF OPEN routine address 
OUT] CLUS. routine address 
UUIS SELECT routine auuress 
0015 INPUT routine addr ess 
OO17 OUTPUT routine address 
0019 Disk c 2 


routine adaress 
OVIB bbe: : nan 


0021 Device type 

0022 Boot priority 

0023 Interrupt priority : 

0024 Presence flag (start of second record for expansion banks) 


The end of the table is indicated by 80H in the Presence flag. 
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: EXINIT 

Inputs 

None. 

Outputs 
_ None. 


Globals Accessed 
None. SYSCOM, 


Globals Modified 


SYSCON. 
—HAX-BARKO 

ARSFLE 
Services Called _ 


iytiea Rs Deg — eis 
Goto Bank. BrpseT % 
Xfer_Bytes WVOVARS (COwT) 


Services Called By 


Init in module Edit. 
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Processing 


assigns 5EEAH to be the starting address of SYSCON 


calls BLDSCT | call VOVARS 
if LROS Coctridse type entry = et 
then¥call GOTO BANK(0, chunk spec, start addr) 
else if AROS cartridge type =2 MLVar 
then if Vang bung = 1 (409) — spl fte Seon : make cog ee op . 
then/call GOTO BANK(255, 0, AROS addr) tal) COMT 
else if lang type = 2 (men ; 
thenf autostart = ] 
then call GOTO BANK(O, chunk spec, 
start addr) 
else call =~ b EL ReoTDEV 


eise error - missing LROS 
noot highest priority device 
save bank #, priority, and boot addr of highest priority 
device (initially 255, 128, LED18 addr for TS2000) 
While not end of SYSCON do 

if presence flag = 1 and device is bootable 

then if device is higher priority than current 
‘high 


then current device becomes current high 
call GOTO _BANK(bank #, chunk spec, boot addr of high device) 


aE 
: Build System Configuration Table 
Inputs | 


None. 


Outputs 


i f 
None. be Complete Li COW table 


Globals Accessed 
eyscow 


None. 


Globals Modified 7 


a 


SYSCON. 
MAX BANK, | ui) 


BS_ MAXK-B4AVE 
RESALL (sr27w2) 


wk 


Pre m ee | 
rvices 4 


Hrite BS Reg ' ASSIE 

Goto Bank. ORE ig AM - 

Call Bank. |” wEwR ANIES 
i REVUM- 


Services Called By 


EXINIT. 
pe ee Lh, | fr RESET dente 


PRT w/ VOTES 


_Initialization 


The TS 2000 undergoes an initialization procedure upon power” on, With the 
addition of the Bus Expansion Unit changes have to be made to allow for the 
new devices and bank switching. 


This section describes the additions and modifications to the Fdit module. 
These are: the addition of a System Configuration Table, channel data tables, 
and some new system variables. 


The new system variables are: 

SYSCON - address of the System Configuration Table 

BEU_CH - address of channel information table for BEU devices 
(equivalent of CHINIT) 

BEUSEL - address of table of BEU device dependent initialization 

routines (equivalent of SELTAB) 

BEU_OP - address of table of BEU device stream open routines 

(equivalent of SPEC_T) 

BEU_CL - address of table of BEU device strean close routines 

(equivalent of CL_TAB) 


The memory map for these tables is thus: 


| 
Gr 
T8, 


ty BAKES xe 


«++DRIVES ! 


PRES EQU 
BOOTAD EQU 
LANG EQU 
SIZ EQU 
PRI EQU 
EBCH EQU 
EBSEL EQU 
EBSTOP EQU 


EBSTCL EQU 
EBIH EQU 
AROSLO EQU 
LROSLO EQU 
EBSIZE EQU 


The location of the 
SYSCON by X * EBSIZE 


SYSCON ! BEU_CH ! BEUSEL ! BEU_OP ! BEU CL ! CHANS... 


The following offsets may be useful in finding the correct locations within 
the SYSCON table. 


OQ j;presence flag 
1 ;boot address 
3 ;language (AROS and LROS only) 
:The following are for BEU devices only 
5 (size of AROS or LROS 
3 “boot priority 
4 ;channel data address 
6 Select initialization routine address 
8 ;Stream open address 
10 ;stream close address » _ 
12 ;interrupt handler address 
0 ;0ffset of AROS 
7 ;offset of LROS 
14 ;size of BEU device information 


b 
table information pertaining to eerie X is offset from 


ee | Sygcar table 


Load BEU 


Inputs 

HL - the location of the table (to be stored in SYSCON) 
Outputs 

HL - first available location after the table. 


Globals Accessed 


Globals Modified 
SYSCON - location of system configuration table. 


Services Called 


Services Called By 
New part of Init in module Edit 


Processing 


channel table 

Inputs 

HL - starting location of channel tables 

Outputs 

HL - ending location of channel tables + 1 

Globals Accessed 

SYSCON 

Globals Modified 

BEU_CH - starting location of BEU channel data table 


BEUSEL - Starting location of BEU select init addr table 


BEU_OP - starting location of BEU stream open addr table 


BEU_CL - starting location of BEU stream close addr table 


Services Called 


Services Called By 


Processing 


HL is loaded into BEU_CH. Then for each device present on the BEU, 
the device spec, bank number, and channel data address go into the 
table. Similarly for select, open, and close. 


Channels Lb 


To accomodate the BEU device channel tables, a new search routine is needed. 
If the search through the permanent device channel tables does not find a 
match, the BEU device channel tables must searched. 


Seach A 


Inputs 


Feit 


C - device spec to be searched for 
HL - address of table to be searched 
Outputs 

HL - address of routine to be called 


Globals Accessed 
Globals Modified 
Services Called 


Services Called By 
Select in module Edit 4éL- ag 
Close in module Changs CL CHA 


Open in module Chans OPCHAN 


Processing 


Searches through table for device spec. If not found on one 
iteration, HL is incremented by 4 and another comparison is made. 
Zero indicates the end of the table. The only difference between 


this and procedure Search in module Edit is that HL gets incremented 
by an additional 2. 
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Processing 
begin - 
MAX BANK := 0 7 S.™4x- BAVK fs o 


XFER BYTES 4 bytes from addr Q of dock bank tu LROS entry of SYSCON 
if cartridge type is hes 1 
then cartridge t = 0 
XFER BYTES ries bytes from 8000H of dock bank to AROS entry 


<— of SYSCON 
if cartridge one is not 2 


then cartridge type := 0 Ae ’ La #) 
(* fill in expansion bank records "all Write BS-Req (emo ,@ Of anh darrry 


Call ASSIGM 
If not clone then 


begin While not ene a 


Se . 
REG eel bie 7 42%) 
Fill in bank # a of SYSCON record 
AFER one byte from extension to addi 0 of MAX_BANK 
XFER, bytes from addr 0 of MAX_BANK to SYSCON entry 
overhead information) 
if first byte is different from what was written 
then there is an intelligent device 
tt device ts—inittetizebte, call CHIR 
else test again in case of fluke ~ 
XFER a different byte to addr 0 of MAX_BANK 
XFER byte back 


if same l| VEWRA 
tender ee Ran 


—set-bit—0-of chunk tdevice}_spee—entry 
ae a ae 54 : 
aceerding ty — ’ 
Soad-4 E t 
else it was a fluke and there is an int. device 
cal] CHIR 


fh, 


Write dorian command to command port to go to next bank 
end (* while *)— 
write 80H to mark end of SYSCUN table 
, a — ee i ; 


call yeEnumM BANKS 


end 


Timex, Inc. TS 2000 System Software Design Spec Page 31 
05/09/83 EG - P - 544 Company Confidential 


:: Channels 


To accomodate the BEU device channel information contained in SYSCON, a new 
search routineX is needed. Also, changes have been made to the Open, Close, 
and Select routines. The data in the stream (STRMS) consists of two bytes 


each. The high order byte indicates whether the stream is attached to an R,4+ Tset 
intelligent device or a dumb device (@ marker of 80H Ts add indicates 
an intelligent device). The two bytes (minus the inteTTigent marker if 


present) indicate the offset of the channel data from either SYSCON (for 
intelligent devices) or CHANS_ (for dumb devices). 


Open (in module CHANS) first searches table SPEC T for the device 
specification. If it is found Open continues as it does in the Spectrum. If 
the device spec is not found, table SYSCUN is searched (using procedure 
SRCHSC). If found, 80H is added to the high order byte of the channel 
information and the device's open routine is called via Call Bank. The 
channel information is then put into the stream data (STRMS). 


Close (in module CHANS) zeros the channel data for the specified stream in 
STRMS. If the high order byte of that data was 80H or greater, table SYSCON 
is searched (using procedure SRCHSC) and that device's close routine is called 
via Call Bank. If the high order byte was less than 80H, Close continues as 
it does in the Spectrum. 


Seleét (in module EDIT) uses the channel data in STRMS to select the current 
1/0 channel. If the high order byte of the channel data is greater than 80H, 
table SYSCON is searched (using procedure SRCHSC). If the search is 
successful the device's select routine is called via Call Bank. If the high 
order byte of the channel data is less than 80H, table SELTAB is searched and 
execution continues as it does in the Spectrum. 
The bank number of the currently selected channel is stored.in CURCBN and is 
used in Select to determine the proper input and output routines. 

¢ ORCHSC 

Inputs 


C - device spec to be searched for. 


Outputs 


# entry of iy clevice recere) 
HL - address of Lok iscsi Be det : 


DE ~ offset of device record from SYSCON 


Globals Accessed 


SYSCUN. 


Timex, Inc. TS 2000 System Software Design Spec Page 32 
05/09/83 EG - P = 544 Company Confidential 
Globals Modified 


None. 


Services Called . 


None. 


_ Services Called By 


SEL_HL in module Edit. 
CLCHAN in module Chans. 
OPCHAN in module Chans. 


Processing 


HL is set to the address of the first device record in SYSCON 
DE is set to Borers of first device record) 


while C # (HL + 2) and (HL) # 80H do 
mH S= HL + 24, OF 12 Oe +a 
if C = (HL) ; 
then set carry flag and increment HL 
else reset carry flag , 


fae 


_ Upon return from a successful search, HL points to the bank number entry 
of the table. 
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